home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / verif10.arc / VERIFIER.DOC < prev    next >
Text File  |  1990-05-19  |  17KB  |  464 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                              User Verifier Door
  24.                               for PCBoard 14.x
  25.                                (Version 1.0)
  26.  
  27.                       to be used in Conjunction with:
  28.                           The Mailing List Manager
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                 Written by:
  42.                                Lance Williams
  43.  
  44.                                Kadet PCBoard
  45.                                P. O. Box 266
  46.                            Camden, NY 13316-0266
  47.  
  48.                                (315) 245-3815
  49.                            USR HST Dual Standard
  50.  
  51.          User Verifier Door                                 Page 1
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.     License Agreement
  59.  
  60.             The Mailing List Manager, Verifier Door & User-Reg utility
  61.     ("The Software") is COPYRIGHT 1990 by Lance Williams, ALL RIGHTS
  62.     RESERVED.
  63.  
  64.             You  may not engage in,  nor permit third  parties to engage
  65.     in, any of the following :
  66.  
  67.             A)   Making alterations of any kind in the software.
  68.  
  69.             B)   ATTEMPTING TO DISASSEMBLE,  DECOMPILE, OR  REVERSE
  70.                  ENGINEER THE SOFTWARE OR THE FILES IT GENERATES IN ANY
  71.                  WAY.
  72.  
  73.             C)   Granting  sub-licenses, lease  or other  rights in the
  74.                  software to others.
  75.  
  76.             D)   This release is SHAREWARE, if you continue to use this
  77.                  package for more than 3 weeks, you must register it with
  78.                  the author.
  79.  
  80.             The author of the software grants you a license to use this
  81.     software as long as you meet the above conditions.  Any violation of
  82.     the above conditions will result in the termination of your license to
  83.     use this software.  Upon termination of this license for any reason,
  84.     you must stop using the software and destroy all copies of it in your
  85.     possession immediately.  In addition, the author reserves the right to
  86.     cancel your license to use this software at any time for any reason
  87.     that he sees fit.
  88.  
  89.              The author of this software is not liable for damages suffered
  90.     as a result of the improper use, proper use, or inability to use this
  91.     software.  This type of disclaimer is prohibited by law in some states,
  92.     and is therefore void in those states.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  109.  
  110.          User Verifier Door                                 Page 2
  111.  
  112.  
  113. General Program Characteristics:
  114.  
  115.             This door serves as a great user verifier by mail for PCBoard
  116.      sysops.  It insures some degree of satisfaction that all of your users
  117.      are real persons.  The door has two functions, the first function is a
  118.      user verifier which requires all new users to stay at a lowered
  119.      security level until they receive a registration number in the mail.
  120.  
  121.             When a new user logs in, you can send him to this door to fill
  122.      out the mailing information for a registration card.  You will have to
  123.      send out cards on a regular basis to your users, and when they get the
  124.      registration number, they can reenter the door and chose option #2,
  125.      verify registration, to be upgraded to a verified user.
  126.  
  127.             The second function is a Mailing List Manager for those of you
  128.      who like to send out occasional flyers and such to your users.  The
  129.      Sysop Utility program (MAILING.EXE) contains many options for printing
  130.      out labels for your users.  See the Documentation file on the Mailing
  131.      program for more details.
  132.  
  133.  
  134. Set-up for Verifier Door:
  135.  
  136.              The Door is very simple to set up if you have ever set up a
  137.      DOORPCH door before.  The configuration file for the door MUST be on
  138.      the command line and contain the following information:
  139.  
  140.      Line 1:  The path/filename of your PCBOARD.SYS file.
  141.      Line 2:  The Name of your BBS.
  142.      Line 3:  Sysop's First Name.
  143.      Line 4:  Sysop's Last Name.
  144.      Line 5:  Path/Filename of your PCBoard USERS file.
  145.      Line 6:  Your Registration Number (0 if Unregistered)
  146.      Line 7:  The various security levels and upgrade level separated
  147.      Thru EOF:     by a comma.
  148.  
  149. Example Configuration File:
  150.  
  151.             C:\PCB\PCBOARD.SYS
  152.             Kadet PCBoard
  153.             Lance
  154.             Williams
  155.             C:\PCB\MAIN\USERS
  156.             0
  157.             3,35
  158.             4,40
  159.             5,45
  160.             6,50
  161.             7,55
  162.             8,60
  163.             9,90
  164.  
  165.  
  166.  
  167.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  168.  
  169.          User Verifier Door                                 Page 3
  170.  
  171.  
  172. Adding the Door to PCBoard:
  173.  
  174.      The implementation of a Door in PCBoard is relatively simple and
  175.      fairly well documented in the PCBoard User Manual.  If you have ever
  176.      installed a DOORPCH door, you will have no problem with this door.
  177.      The batch file to call the door is also standard to any DOORPCH Door.
  178.  
  179. Sample Batch File:
  180.  
  181.      @echo off
  182.      e:
  183.      cd \doors\verifier           <---  Location of the Door Files
  184.      verifier verifier.cfg        <---  Be sure to include CFG file on
  185.      c:                                 command line.
  186.      cd \pcb                      <---  Return to the PCBoard Directory
  187.      board
  188.  
  189.  
  190. Files Used by Program:
  191.  
  192.      BRUN45.EXE
  193.             All the programs in this package require a copy of the
  194.      QuickBasic 4.5 Runtime Library.  The Door requires a version patched
  195.      for proper DTR handling.  Call my system if you need a copy.
  196.  
  197.      VERIFIER.CFG
  198.             This is the door configuration file.  See above.  (also used
  199.      by MAILING.EXE & USER-REG.EXE)
  200.  
  201.      VERIFIER.DAT
  202.             This is a file the Door uses to track users of the verification
  203.      door.  It is written to when someone verifies his/her registration.
  204.      It is checked to not allow a user to verify registration more than
  205.      once.  (Created by Program)
  206.  
  207.      MAILLIST.DAT
  208.             This is the Mailing List Data file used by both the Verifier
  209.      Door and the Sysop Utility program (MAILING.EXE).  It contains all the
  210.      mailing addresses for your users that have gone through the door.
  211.      (Created by program)
  212.  
  213.  
  214. Files included in archive:
  215.  
  216.      VERIFIER.EXE     Verifier Door Program
  217.      MAILING.EXE      Sysop Utility Program
  218.      USER-REG.EXE     Simple Program to get registration numbers
  219.      VERIFIER.CFG     Sample VERIFIER/MAILING/USER-REG configuration file
  220.      VERIFIER         Sample Batch File to Run Door
  221.      VERIFIER.DOC     This Documentation file
  222.      MAILING.DOC      Documentation for Sysop Utility Program
  223.      USER-REG.DOC     Simple Docs for USER-REG program.
  224.  
  225.  
  226.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  227.  
  228.          User Verifier Door                                 Page 4
  229.  
  230.  
  231. Multi-Node Operations:
  232.  
  233.             Since I do not have a multi-node system, I can not verify that
  234.      this system will work properly on Multi-Node systems.  I do know there
  235.      are problems with Double DOS and DOORPCH, so you might have this door
  236.      on only one system, run some sort of check to be sure the system is
  237.      not operating on two nodes at one time.  I followed all the
  238.      instructions in DOORPCH for Multi-node operations, but I have no way
  239.      of testing it at this time.
  240.  
  241.  
  242. File Formats:
  243.  
  244.             The following is the file format for the Mailing List data file
  245.      for anyone who wishes to write any other utilities for the package.
  246.      The only thing I request is that you send me a copy of your program,
  247.      preferable including source code.  I like to know what is going on
  248.      with my efforts.
  249.  
  250.      Mailing List Data File:   (Total Length = 160 bytes)
  251.  
  252.             1,25   Ascii     User Name as in PCBoard User Record
  253.            26,30   Ascii     Proper Mailing Name on Label
  254.            56,30   Ascii     Address as Printed on Label
  255.            86,30   Ascii     City, State, Zip for Label
  256.           116,16   Ascii     Date/Time Information was entered
  257.           132, 2   MKI$      Flag for Registration Card Sent (1 = Sent)
  258.           134, 2   MKI$      Send only Regular Mailings (1 = Yes)
  259.           136, 2   MKI$      Delete Flag (1 = Delete)
  260.           138, 2   MKI$      Selective Printing Flag (1 = Print)
  261.           140,21   Ascii     Saved For Future Use
  262.  
  263.  
  264. Original Ideas & Future Plans??
  265.  
  266.             Well, I can't say what the future may bring for this program
  267.      set.  I originally started this as a simple mailing label printer for
  268.      a monthly newsletter.  I got tired of maintaining a mailing list
  269.      program myself, and decided it would be easier to have my users do it
  270.      themselves.  So, I started the program about a year ago.  Then I got
  271.      the idea recently to add the User Registration Door to the system,
  272.      after being on a couple systems that use a similar idea, but they
  273.      never offered it out publicly.  I figured the reason was they never
  274.      thought of a good algorithm idea to make every board different.  I
  275.      overcame this problem by using both the UserName and Board information
  276.      (Sysop Name & Board Name).  I extract ASCII Values from various
  277.      locations of all of the different names and use these values in a
  278.      mathematical equation.  That is how I get a different registration
  279.      number for every user on different systems.
  280.  
  281.             And, as far as the future is concerned, if anyone has any
  282.      suggestions, feel free to pass them along my way.
  283.  
  284.  
  285.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  286.  
  287.          User Verifier Door                                 Page 5
  288.  
  289.  
  290. Revision History:
  291.  
  292.      03/05/90  Version 0.50
  293.  
  294.             Initial finished coding for verifier of users.  Tested, but
  295.      never put online.
  296.  
  297.      03/15/90 - 04/28/90
  298.  
  299.             Did extensive work on MAILING.EXE program, so the Door part sat
  300.      and waited till I got the Sysop Utility done.
  301.  
  302.      04/30/90  Version 0.60
  303.  
  304.             After a short hiatus from this program, I got back to this one
  305.      again.  I added better screen displays, and installed some of the
  306.      routines from the Sysop Utility for verification checking.
  307.  
  308.      05/04/90  Version 0.70
  309.  
  310.             Added Ability to have users input their address into the
  311.      database from the door.  Worked up an editor/creator routine from the
  312.      subroutines in MAILING.EXE.
  313.  
  314.      05/05/90  Version 0.80
  315.  
  316.             Found that the DOORPCH routines were not working properly on
  317.      remote.  Screen alignment incorrect on remote systems when using some
  318.      of the routines in DP36QB45.LIB.  Re-aligned/redesigned the
  319.      editor/creator for the mailing list manager part of the door to
  320.      accommodate the faulty library.
  321.  
  322.      05/06/90  Version 0.90
  323.  
  324.             Added Opening and Closing screens.  Tested on remote and local
  325.      mode.  Placed system online on my system for extensive testing by my
  326.      users.  Started writing this documentation to release the program
  327.      officially by May 20th (Hopefully).
  328.  
  329.      05/12/90  Version 0.95
  330.  
  331.             Fixed bug where new users were not being flagged properly for
  332.      printing of registration label.  This was my first run with real users
  333.      and printing labels for registration postcards.
  334.  
  335.      05/19/90  Version 1.00
  336.  
  337.             First general release.  After 2 weeks of local testing & no
  338.      major problems, I guess it's ready to go.  Complete with Mailing List
  339.      Manager program for sysop maintenance.   I fixed some minor display
  340.      typos, but nothing serious.
  341.  
  342.  
  343.  
  344.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  345.  
  346.          User Verifier Door                                 Page 6
  347.  
  348.  
  349. Registration for Complete Package:
  350.  
  351.             This package is distributed as Shareware.  You are required to
  352.      register it if you continue to use it after a 3 week trial period.
  353.      To register, fill out the following registration form and send to:
  354.  
  355.                                Lance Williams
  356.                                P. O. Box 266
  357.                            Camden, NY 13316-0266
  358.  
  359.             Registration for the User Verifier Door and Sysop Utility
  360.      program is $30 payable in Cash/Check or Money Order in US Funds.
  361.      Registration includes a complimentary set of 100 printed post cards
  362.      in the following form:
  363.           ┌────────────────────────────────────────────────────────┐
  364.           │                                                        │
  365.           │                                                        │
  366.           │                                                        │
  367.           │                                                        │
  368.           │                   YOUR BBS NAME HERE                   │
  369.           │                                                        │
  370.           │                                                        │
  371.           │                                                        │
  372.           │           Welcome!  Since  you  are a new  caller      │
  373.           │      to this BBS, you are required to verify your      │
  374.           │      registration  through  the verification door      │
  375.           │      with  the registration number on the address      │
  376.           │      side of this card.                                │
  377.           │                                                        │
  378.           │           The next time you call this  BBS, enter      │
  379.           │      the verification  door and choose option  #2      │
  380.           │      from  the  main  menu.   Enter  your  number      │
  381.           │      for registration verification at the prompt.      │
  382.           │                                                        │
  383.           │                                                        │
  384.           │                                                        │
  385.           │                                                        │
  386.           └────────────────────────────────────────────────────────┘
  387.  
  388.             The address side of the postcard will also be printed with a
  389.      3 line return address.  If the address is different than the shipping
  390.      address, be sure to specify the address to print on the cards.  Please
  391.      allow 4 - 6 weeks for delivery of cards, but your registration number
  392.      will be sent separately within 10 days to 2 weeks.
  393.  
  394.             These cards will also be available at $4.95 per 100 cards while
  395.      supplies last.  I run a printing shop and have a good supply of post
  396.      card stock in assorted colors, and am offering these printed and boxed
  397.      cards at a very reasonable price.
  398.  
  399.  
  400.  
  401.  
  402.                ***  User Verifier Door Registration Form  ***
  403.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  404.  
  405.          User Verifier Door                                 Page 7
  406.  
  407.  
  408.  
  409.      Lance,
  410.             I wish to register your User Verifier Door & Mailing Utility
  411.      program.  Enclosed is $30.  Please send my registration number and
  412.      complimentary set of post cards to:
  413.  
  414.             Name : ________________________________________________
  415.          Address : ________________________________________________
  416.             City : _________________  State: _____  Zip: __________
  417.  
  418.      In case of problems you can reach me at:
  419.  
  420.      Voice Phone : _________________  Data Phone : ________________
  421.  
  422.    *** The following MUST be the Same as in your Configuration file: ***
  423.  
  424.                  Sysop Name : __________________________
  425.                    BBS Name : __________________________
  426.  
  427.      (The above will be printed on your Registration Post Cards and be)
  428.       (used to create your personal registration number for the door)
  429.  
  430.  
  431.    ────────────────────────────────────────────────────────────────────────
  432.  
  433.  
  434.            ***  Order Form for More Registration Post Cards  ***
  435.  
  436.  
  437.      Lance,
  438.             I'd like to order additional postcards for the User
  439.      Verification Door.  Please send them to the following address:
  440.  
  441.  
  442.             Name : ________________________________________________
  443.          Address : ________________________________________________
  444.             City : _________________  State: _____  Zip: __________
  445.  
  446.  
  447.      Please send _____ sets of 100 cards @ $4.95 per set made out with the
  448.      following information:
  449.  
  450.      Return address if different than above:
  451.  
  452.             Name : ________________________________________________
  453.          Address : ________________________________________________
  454.             City : _________________  State: _____  Zip: __________
  455.  
  456.         BBS Name : ________________________________________________
  457.  
  458.  
  459.  
  460.  
  461.  
  462.       Lance Williams, Kadet PCBoard, (315) 245-3815 USR HST Dual Std.
  463.  
  464.